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PREFACE 



This manual details the OS/32 run-time library (RTL) subroutines 
and intrinsic routines for the Model 3200MPS System. The Model 
3200MPS System features a FORTRAN interface that facilitates the 
manipulation of system resources. Through applications tasks 
written in Perkin-Elmer FORTRAN VII language, the RTLs documented 
m this manual can be used to control these extensive system 
resources. The capabilities available to application tasks on 
the Model 3200MPS System are comprehensive. For details on the 
features of these RTLs and their uses, see the Model 3200MPS 
System Overview Manual. 

Chapter 1 of this manual consists of FORTRAN RTL intrinsic 
routines designed to measure real-time for the Model 3200MPS 
System and to allow for task self-control. Chapter 2 consists of 
FORTRAN VII RTL subroutines that provide for multiprocessor 
system support. 

The information in this manual is applicable to OS/32 R07.2 
software release or higher. 

For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAI>TER 1 
INTRINSIC ROUTINES 



1.1 INTRODUCTION 

The following intrinsic routine« are recognized by the FORTRAN 
VII compilers. See the Model 3200MPS System Overview Manual for 
application examples of the uses of these routines. 



WARNING 

THE RUN-TIME LIBRiVRY (RTL) SUBROUTINES 
FOR THE MODEL 3200MPS SYSTEM, AS 
DOCUMENTED IN THE FOLLOWING SECTIONS, ARE 
APPLICABLE ONLY TO USERS OF OS/32 R07.2 
SOFTWARE RELEASE OR HIGHER. USERS OF A 
MODEL 3200MPS SYSTEM RUNNING UNDER OS/3 2 
R07.1 SOFTWARE RELEASE MUST CONSULT THE 
FORTRAN VII USERS GUIDE FOR DOCUMENTATION 
OF MODEL 3200MPS RTL SUBROUTINES AND 
INTRINSICS. 



The FORTRAN O and Z compilers translate all calls to these 

intrinsic routines into their respective instruction sequences. 

Except when stated otherwise,. all of their arguments are 
integer *4 scalars. 

1.2 GOAPU Subroutine 

The GOAPU subroutine enables the logical processing unit (LPU) 
assignment. If the eligibility requirements are satisfied, the 
calling task is placed on the auxiliary processing unit (APU) 
execution queue. This queue is specified in the logical 
processor mapping table (LPMT) . Call GOAPU as follows: 



Format: 



CALL G0APU([APU_ID3) 
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Argument : 



APU_ID 



is an optional integer *4 variable to which 
GOAPU returns a value as follows: 



APU 
Number 



-1 



indicates the task is running on 
the central processing unit (CPU) 
after invocation of this 
subroutine. 

indicates the number on which the 
task is running after invocation 
of this subroutine. 

indicates that the APU_ID of the 



processor 
currently 
accessed, 
occur in 
failure. 



on which the task is 

running cannot be 

This value should only 

the event of hardware 



Functional Detail: 

In order to transfer the calling task to an APU, an LPU must be 
assigned to this task and the APU mapped to the assigned queue. 



NOTE 

If the calling task is mapped to an 
execution queue with multiple processors, 
APU_ID should be used with caution as the 
task may move to other processors after 
the GOAPU subroutine is called. 



1.3 GOCPU Subroutine 

The GOCPU subroutine transfers the calling task to the CPU. 

Format : 

CAUL GOCPU 



1-2 



48-152 FOO ROO 



1.4 GENS I G Subroutine 

The GENSIG subroutine is used to instruct sui APU to pulse a 
specified line of a real-time support module (RTSM) . The number 
of the RTSM line is specified in the input argument. For more 
inforrvation on the RTSM, see the Model 3200MPS Real-Time Support 
Module (RTSM) Progreimming Reference Manual. 



Format: 



CALL GENS I G ( APU_NO , S I GNAL_NCl , APU_ I D [ , STATUS ] ) 



Arguments : 



APU_NO 

SIGNAL_NO 

APU_ID 

STATUS 



is an integer*4 input argument that specifies 
the APU number . 

is an integer *4 input argument that specifies 
the output line number. 

is an integer *4 output argument in which 
GENSIG loads the APU_ID number of the 
processor executing the calling task. 

is an optional integer *4 variable to which 
GENSIG sends a status code (see Table 1-1 for 
possible status codes) . 



Functional Details: 



The hard-wired ID number of the 
running) is read. If this nu 
value of -1 is returned in t 
negative, the signal is sent t 
APU identification is returned i 
not negative, the APU_NO is 
number of the processor on which 
number does not match the APU_ 
status code of 3 is returned in 
line is not pulsed (see Tabl 
otherwise, the selected output 1 
must specify ai valid pulse outpu 
the signal is sent to an unexpec 
the modulo- 8 of that SIGNAL_NO. 



processor (on which the task is 
mber cannot be determined, then a 
he APU_ID. If the APU_NO is 
o the selected pulse line and the 
n the APU_ID. If the APU_NO is 
compared with the hard-wired ID 
the task is running. If this 
NO (when executing on the APU) , a 
STATUS and the selected output 
e 1-1 for possible status codes), 
ine is pulsed. The SIGNAL_NO 
t line number from to 7 or else 
ted line having a number equal to 
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TABL£ 1-1 STATUS CODES FOR THE 
GENS I G SUBROUTINE 



CODE 



I STATUS I 

I No error, requested function completed | 





1 I Pulse output device cannot be accessed | 
I I 

2 I APU cannot be accessed I 

I I 

3 I APU number is illegal | 



1.5 IRTCNT Function 

This integet*4 function returns the value of the real-time 

counter (RTC) of the CPU or APU in which the calling task is 

executing. The value is between -2^^ and 2"''' -1 inclusive. 



Format: 



I RTCNT ( [ STATUS ] ) 



Argximent : 



STATUS 



is an optional integer*4 variable to which 
IRTCNT sends a status code. 



Functional Detail: 

If STATUS is nonzero, the value of the function is zero (see 
Table 1-2 for possible status codes). 



TABLE 1-2 STATUS CODES FOR THE IRTCNT FUNCTION 

CODE I STATUS 

I No error, requested function completed 



1--4 
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1.6 RSCHDL Subroutine 

The RSCHDL subroutine transfers the calling task to the end of 
the ready queue of the processor in which the task is executing. 

Format : 



CALL RSCHDL 



WAIRNING 

USE OF THIS SUBROUTINE IN CONJUNCTION 
WITH PRIORITY OR PRIORITY-ENFORCED QUEUE 
DISCIPLINE MAY SERIOUSLY DEGRADE SYSTEM 
THROUGHPUT. USE OF NO PRIORITY IS 
RECOMMENDED. 
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CHAPTER 2 
RUN -TIME LIBRARY (RTL) SUBROUTINES 



2.1 INTRODUCTION 

This chapter contains the Model 3200MPS System real-time routines 
that are included in the FORTRAN VII RTL. For complete 
descriptions of these RTL's, see the Model 3200MPS System 
Overview Manual. 



WARNING 

THE RTL SUBROUTINES FOR THE MODEL 3200MPS 
SYSTEM, AS DOCUMENTED IN THE FOLLOWING 
SECTIONS, ARE APPLICABLE ONLY TO USERS OF 
OS/32 R07.2 software; RELEASE OR HIGHER. 
USERS OF A MODEL 3200MPS SYSTEM RUNNING 
UNDER OS/32 R07.1 SOFTWARE RELEASE MUST 
CONSULT THE FORTRAN VII USERS GUIDE FOR 
DOCUMENTATION OF MODEL 3200MPS RTL 
SUBROUTINES AND INTRINSICS. 



Except where otherwise stated, all paraimeters of these routines 
are integer *4 scalars. TASKID is an 8-byte input argument 
containing the name of the directed task. The task name is 
left- justified and padded to the right with blanks, if necessary. 

Examples : 

DOUBLE PRISCISION TASKID 
DATA TASKID /'NAME '/ 
CALL TRLPU(TASKID, . . . ) 

INTEGER* 4 TASKID(2) 
DATA TASKID /'NAME '/ 
CALL TRLPU(TASKID, . . . ) 
CALL TRLPU ( 8HNAME , . - - ) 
CALL TRLPUC NAME ',...) 

CHARACTERS* 8 TASKID 
TASKID = 'NAME ' 
CALL TRLPU(TASKID, . . . ) 
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2.2 APUDABL Subroutine 

The APUDABL subroutine is used 
auxiliary processing unit (APU) . 



to disable the designated 



Format: 



CALL APUDABL ( APU_NO , STATUS ) 



Arguments : 

APU_NO 
STATUS 



is an integer *4 input argument that specifies 
the APU that is to be disabled. 

is an integer *4 variable to which APUDABL 
sends a status code (see Table 2-1 for 
possible status codes). 



TABLE 2-1 STATUS CODES FOR THE APUDABL SUBROUTINE 

STATUS 
I No errors 

4 I Errors, task options prevent granting of privilege 

5 I Task has not been granted privileges required to 
i perform option 

6 I Invalid APU number 

11 I APU not enabled (DISABLED state) 

16 Cannot disable unless APU is in ENABLED state 



2.3 APUENAB Subroutine 

The APUENAB subroutine is used to enable the designated APU, 

Format : 

CALL APUENAB (APU_NO, STATUS) 



2-1 
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Arguments : 
APU_NO 
STATUS 



is an integer *4 input argument designating the 
APU that is to be enabled. 

is an integer *4 variable to which APUENAB 
sends a status code (see Table 2-2 for 
possible status codes). 



TABLE 2-2 STATUS CODES FOR THE APUENAB SUBROUTINE 



I CODE 

! ° 
I 

I 4 

I 

I 

I 5 

I 
I 



6 
14 
15 



STATUS 

No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Invalid APU number 

Cannot enable unless APU is in DISABLED state 

APU could not pass power-up link check sequence; 
APU left in DISABLED state 



2.4 ASGNQUE Subroutine 

The ASGNQUE subroutine is used to assign the specified APU to the 
designated queue. 



Format: 



CALL ASGNQUE (APU_NO,QUE_NOr STATUS) 



Arguments : 
APU_NO 
QUE_NO 



is an integer *4 input argument specifying the 
APU number . 

is an integer* 4 input argument designating the 
queue number . 
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STATUS 



Is an Integer *4 variable to which ASGNQUE 
sends a status code (see Table 2-3 for 
possible status codes). 



TABLE 2-3 STATUS CODES FOR THE ASGNQUE SUBROUTINE 



CODE 


1 STATUS 





1 No errors 


4 


1 Error, task options prevent granting of privilege 


5 


1 Task has not been granted privileges required to 
1 perform option 


6 


1 Invalid APU number 


11 


1 APU not enabled (DISABLED state) 


12 


1 Access to QUE could not be obtained 


21 


1 Invalid QUE number 



2.5 ASLPU Subroutine 

The ASLPU subroutine assigns the designated logical processing 
unit (LPU) to the directed task. 



Format: 



CALL ASLPU (TASKID,LPU_NO, STATUS) 



Arguments 



TASK ID 



LPU_NO 



is an 8-byte input argument containing the 
task name. If the argument is an integer* 4 
zero, the call is self -directed. 

is an integer *4 input argument specifying the 
LPU number . 



STATUS 



is an integer*4 variable to which ASLPU 
returns a status code after execution (see 
Table 2-4 for possible status codes). 



2-4 
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TABLE 2-4 STATUS CODES FOR THE ASLPU SUBROUTINE 

CODE j STATUS 

I No error, requested function completed 

1 I Syntax error in TASK ID 

4 I No such task in calling task environment 

9 I The calling task cannot execute SVC6 control or 

I communication functions 

84 I LPU number is outside sysgened range 

85 I Specified task is AJPU only 



2.6 CNTLAPU Subroutine 

The CNTLAPU subroutine is used by a task to gain control rights 
over the designated APU. 



Format 



CALL CNTLAPU ( APU_NO , STATUS ) 



Arguments : 
APU_NO 

STATUS 



is an integer*4 input argument that specifies 
the APU over which control rights are to be 
gained by the calling task. 

is an integer*4 variable to which CNTLAPU 
sends a status code (see Table 2-5 for 
possible status codes). 
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TABLE 2-5 STATUS CODES FOR THE CNTLAPU SUBROUTINE 



CODE I STATUS 

I No errors, requested function completed 



4 
6 



Task errors prevent granting of privilege 



I Invalid APU number 



I Privilege is currently owned by another task | 



2.7 HALTAPU Subroutine 

The HALTAPU subroutine causes the designated APU to stop (as in 
STOPAPU) and save the power fail image . 



Format : 



CALL HALTAPU (APU_NO,HARDWARE_STATUS , STATUS) 



Arguments: 
APU_NO 



HARDWARE_STATUS 



STATUS 



is an integer *4 input argument 
specifies the APU number. 



that 



is an integer *4 variable that indicates 
the 2 -byte APU response status from the 
APU processor hardware. See the OS/32 
Supervisor Call (SVC) Reference Manual 
for more information. 

is an integer *4 variable to which HALTAPU 
sends a status code (see Table 2-6 for 
possible status codes). 



2-6 



48-152 FOO ROO 



TABLE 2-6 STATUS CODES FOR THE HALTAPU SUBROUTINE 



CODE I STATUS 

I No errors 

4 j Error, task options prevent granting of privilege 

5 I Task has not been granted privileges required to 
I perform option 

6 I Invalid APU number 

11 I APU not enabled (DISABLED state) 

18 I Task to be preempted, not on specified APU ready 

i queue. 



Functional Detail: 

This call is similar to STOPAPU except that the save power fail 
image is performed. Therefore, HALTAPU has a greater impact on 
the system because of the additional overhead. 

2.8 IDAPU Function 

This integer*4 function returns the APU_ID number of the 
processor executing the calling task. This function returns a 
value of -1 if the device specified by APU_ID cannot be read. 
Implementation of this function is via the GSIG instruction. 



Format: 



IDAPU () 



2.9 LPUPREF Subroutine 

The LPUPREF subroutine changes the LPU-directed option of the 
directed task. 



Format : 



CALL LPUPREF (TASK ID, FLAG, STATUS) 
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Arguments : 



TASKID is an 8-byte input argument containing the 
task name. If this argument is an integer *4 
zero, the call is self -directed. 

FLAG is an input L0GICAL*4 argument. If FLAG is 

.TRUE., the LPU-directed option of the 
directed task is turned on. If FLAG is 
.FALSE., the LPU-directed option of the 
directed task is turned off. 

STATUS is an integer *4 variable to which LPUPREF 
returns a status code after execution (see 
Table 2-7 for possible status codes). 



TABLE 2-7 STATUS CODES FOR THE LPUPREF SUBROUTINE 



STATUS 

I No error, requested function completed 

I 
I 

1 I Syntax error in task nsune field 

I 
4 I Directed task not present in the calling task 



9 I The calling task cannot execute SVC6 or communication 
I function 



2.10 LPUQUE Subroutine 

The LPUQUE subroutine maps the designated LPU to the designated 
queue. 

Format: 



CALL LPUQUE ( LP U_NO,QUE_NO, STATUS) 
Arguments : 



LPU_NO is an integer*4 input argument that specifies 

the LPU number . 
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QUE_NO 



STATUS 



is an integer*4 input argument that specifies 
the queue number . 

is an integer *4 variable to which LPUQUE sends 
a status code (see Table 2-8 for possible 
status codes) . 



CODE 

4 
5 

7 
13 



TABLE 2-8 STATUS CODES FOR THE LPUQUE SUBROUTINE 

STATUS 

No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Invalid LPU number 

Task has not been granted mapping rights over the APU 
currently mapped to the specified LPU 



21 I Invalid QUE number 



2.11 MAPQUE Subroutine 

The MAPQUE subroutine is used to gain the mapping rights of the 
designated queue. 



Format: 



CALL MAPQUE ( QUE_NO , STATUS ) 



Arguments : 



QUE_NO 



STATUS 



is an integer *4 input argument designating the 
queue for which mapping rights are requested. 

is an integer *4 variable to which MAPQUE sends 
a status code (see Table 2-9 for possible 
status codes) . 
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TABLE 2-9 STATUS CODES FOR THE MAPQUE SUBROUTINE 



CODE I STATUS 

I No error, requested function completed 

4 I Task options prevent granting of privilege 

5 I Task has not been granted privileges required to 
I perform option 

9 I Privilege is currently owned by another task 

21 I Invalid QUE number 



2.12 MAPTABL Subroutine 

The MAPTABL subroutine fetches the maximum LPU number, the 
maximum APU number, the APU-to-APU queue assignment table and the 
LPU-to-APU queue mapping table. If there are no errors, this 
information is stored in the integer*4 array buffer. 



Format: 



CALL MAPTABL ( BUFFER, BUFFEP_LENGTH,LENGTH_USED, STATUS) 



Arguments : 



BUFFER 



is an integer *4 array that is filled using the 
format in Figure 2-1. 



BUFFERJLiENGTH is an input argument indicating the number of 

elements in the array BUFFER that can be 
overwritten in this call. If STATUS is 
nonzero, BUFFER is unchanged. 



LENGTFLUSED 



STATUS 



is an output argument indicating the nun±>er of 
elements in the array BUFFER actually filled 
by MAPTABL. 

is an integer*4 variable to which MAPTABL 
sends a status code (see Table 2-10 for 
possible status codes). 
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0(0) 
Reserved 



1(1) 

Maximum APU 
number 



2(2) 
Maximum LPU 
number 



3(3) 

Reserved 



4(4) 



8(8) 



12(C) 



APU-to-APU queue assignment table 



16(10) 



LPU-to-APU queue mapping table 



Figure 2-1 Format of Elements in the Array BUFFER 
Used by the MAPTABL Subroutine 



TABLE 2-10 STATUS CODES FOR THE MAPTABL 
SUBROUTINE 



CODE 

£ sa SB »'. St a 


1 
2 
3 



STATUS 
No errors, requested function completed 
Buffer alignment error 
Buffer not writable 
Insufficient buffer space 



Functional Details: 

The APU-to-APU queue assignment table is a 12-byte array (0:m) of 
1-byte entries, where m is the maximum APU number. Each number, 
i, contains the APU queue number to which APU i is mapped, where 
APUO-CPU. Entries for i > maximum APU number are zero and not 
meaningful. The CPU entry is always 0. 
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The LPU-to-APU queue mapping table is a variable length array 
(0:n) of 1-byte entries, where n is the maximum LPU number. Each 
entry number, k, contains the APU queue number to which LPU k is 
mapped. LPUO is always mapped to queue 0. For more information, 
see the OS/32 Supervisor Call (SVC) Reference Manual. 



2.13 QUEOFF Subroutine 

The QUEOFF subroutine marks off the designated queue. 

Format : 



CALL QUEOFF ( QUE_NO , STATUS ) 



Arguments : 
QUE_NO 
STATUS 



is an integer*4 input argument that specifies 
the number of the queue to be marked off. 

is an integer *4 variable to which QUEOFF sends 
a status code (see Table 2-11 for possible 
status codes) . 



TABLE 2-11 STATUS CODES FOR THE QUEOFF SUBROUTINE 



CODE 

4 
5 

12 
21 



STATUS 



No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Access to QUE could not be obtained 

Invalid QUE number 



2.14 QUEON Subroutine 

The QUEON subroutine marks on the designated queue. 



2-12 
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Format : 



CALL QUEON ( QUE_NO , STATUS ) 



Arguments : 
QUE„NO 
STATUS 



is an integer *4 input argument that specifies 
the queue to be marked on. 

is an integer*4 variable to which QUEON sends 
a status code (see Table 2-12 for possible 
status codes) . 



table: 2-12 STATUS CODES FOR THE QUEON SUBROUTINE 



CODE I STATUS 

No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

21 I Invalid QUE number 



2.15 QUEXON Subroutine 

The QUEXON subroutine marks the designated queue ON-exclusive. 

Format: 

CALL QUEXON (QUE_NO, STATUS , TASK ID) 



Arguments : 
QUE_NO 



is an integer *4 input argument that specifies 
the number of the queue to be marked 
ON-exclusive. 
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STATUS 



TASK ID 



is an integer *4 variable to which QUEXON sends 
a status code (see Table 2-13 for possible 
status codes) . 

is an 8-byte input argument containing the 
task name for which the queue is to be marked 
ON-exclusive. An integer *4 zero in this 
argument means this call is self -directed. 



TABLE 2-13 STATUS CODES FOR THE QUEXON SUBROUTINE 



STATUS 
No errors 

Syntax error in TASKID 
Insufficient buffer space 
Error, task options prevent granting of privilege 



Task has not been granted privileges required to 
perform option 

QUE cannot be marked ON-exclusive from on state 

Task could not be found in system, APU not marked 
ON-exclusive 

Invalid QUE number 

The QUE cannot be marked ON-exclusive because more 
than one APU is currently assigned to it 



2.16 RELCNTL Subroutine 

The RELCNTL subroutine releases controlling rights over the 
designated APU. 



Format: 



CALL RELCNTL (APU_NO, STATUS) 



2-14 



48-152 FOO ROD 



Arguments 



APU„NO 



STATUS 



is an integer *4 input argument that specifies 
the APU for which controlling rights are to be 
released. 

is an integer *4 variable to which RELCNTL 
sends a status code (see Table 2-14 for 
possible status codes). 



TABLE 2-14 STATUS CODES FOR THE RELCNTL SUBROUTINE 



CODE 

4 
5 



STATUS 

No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Invalid APU number 



2.17 RELMAP Subroutine 

The RELMAP subroutine is used by a task to release the mapping 
privileges of the specified APU queue. 



Format; 



CALL RELlylAP (QUE_NO, STATUS) 



Arguments : 
QUE_NO 
STATUS 



is an integer*4 input argument that specifies 
the queue number . 

is an integer *4 variable to which RELMAP sends 
a status code (see Table 2-15 for possible 
status codes) . 
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TABLE 2-15 STATUS CODES FOR THE RELMAP SUBROUTINE 

CODE I STATUS 

I No errors 

4 I Error, task options prevent granting of privilege 

5 I Task has not been granted privileges required to 
perform option. 

Invalid QUE number 



2.18 REMQUE Subroutine 

The REMQUE subroutine maps all LPUs mapped to the specified QUE 
to queue . 

Format: 

CALL REMQUE (QUE_NO, STATUS ) 



Arguments 



QUE_NQ 



STATUS 



is an integer *4 input argument that specifies 
the queue number . 

is an integer *4 variable to which REMQUE sends 
a status code (see Table 2-16 for possible 
status codes) . 
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TABLE 2-16 STATUS CODEIS FOR THE REMQUE SUBROUTINE 



CODE 

4 
5 

21 
22 



s»==si=!3mm>«»ia!5 



STATUS 



No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Invalid QUE number 

Specified option is not applicable to QUE to which the 
mapping function is directed 



2.19 RSCHAPU Subroutine 

The RSCHAPU subroutine causes the designated APU to place the 
active task at the end of its ready queue and to replace it with 
another task in its ready queue. 



Format ; 



CALL RSCHAPU ( APU_NO , HARDWARE_STATUS , STATUS [ , TASK ID]) 



Arguments : 



APU_NO 



HARDWARE_STATUS 



STATUS 



is an integer *4 input argument 
specifies the APU number. 



that 



is an integer *4 variable that indicates 
the 2-tayte APU response status from the 
APU processor hardware. See the OS/3 2 
Supervisor Call (SVC) Reference Manual 
for more information. 

is an integer *4 variable to which RSCHAPU 
sends a status code (see Table 2-17 for 
possible status codes). 
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TASK ID 



is an optional 8-byte input argument 
containing the neune of the task to be 
rescheduled. If this parameter is not 
present, the next active task on the 
designated APU is rescheduled. 



Functional Detail: 

If TASKID is currently suspended, this subroutine releases it. 
This call cannot be self -directed. 



TABLE 2-17 STATUS CODES FOR THE RSCHAPU SUBROUTINE 



STATUS 

No errors 

Insufficient buffer space for TASKID 

Error, task option prevent granting of privilege 

Task has not been granted privileges required to 
perforin option 

Invalid APU number 

APU not enabled (DISABLED state) 

Access to task queue for the specified APU could not 
be obtained 

Error in transmission/execution of command 

Task to be preempted, not on specified APU ready 
queue 



2.20 SETQUED Subroutine 

The SETQUED subroutine is used to select a specified queue 
discipline for the designated queue. 



Format : 



CALL SETQUED (QUE_NO, QUE_D IS , STATUS) 
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Arguments: 
QUE_NO 
QUE_DrS 



is an integer *4 input argument that designates 
the queue number . 

is an integer *4 input argument that specifies 
one of the following queue discipline numbers: 



indicates no priority. 

1 indicates priority. 

2 indicates priority-enforced. 



STATUS 



is an integer *4 variable to which SETQUED 
sends a status code (see Table 2-18 for 
possible status codes). 



TABLE 2-18 STATUS CODES FOR THE SETQUED SUBROUTINE 



CODE 

4 
5 

12 
21 
23 



STATUS 



ISBViKI'BSII 



s sau TEas? 



No errors 

Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Access to QUE could not be obtained 

Invalid QUE number 

QUE discipline specified is undefined 



2.21 STAQUE Subroutine 

The STAQUE subroutine returns information about the designated 
queue. 



Format ; 



CALL STAQUE ( QUE_NO , BUFFER , BUFFER_LENGTH , LENGTH_USED , 
HARDWARE_STATUS , STATUS ) 
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Arguments : 
QUE_NO 
BUFFER 



BUFFER_LENGTH 



LENGTH_USED 



HARDWARE_STATUS 



STATUS 



is an integer* 4 input argument specifying 
the QUE number . 

is an integer* 4 array that remains 
unchanged if STATUS is nonzero. 
Otherwise, BUFFER is filled using the 
format in Figure 2-2. 

is an input integer *4 argument that 
indicates the number of elements in the 
array BUFFER that can be overwritten in 
this call. The minimum size is 24 bytes. 

is an integer *4 variable that indicates 
the number of elements in BUFFER actually 
filled by STAQUE. 

is an integer* 4 variable that indicates 
the 2-byte APU response status from the 
APU processor hardware. See the OS/32 
Supervisor Call (SVC) Manual for more 
information. 

is an integer*4 variable to which STAQUE 
sends a status code (see Table 2-19 for 
possible status codes). 



2-20 



48-152 FOO ROD 



0(0) 

Unused 



1(1) 
Queue 
number 



2{2) 



Number of tasks 
in the queue 



4(4) 

Queue processing status 



16(6) 



17(7) 

I Number of 
I APUs assigned! I.PUs mapped 



I Number of 



8(8) 



12(C) 



Mapping task name 



16(10) 



20(14) 



Queue task name (1) 
or current exclusive task ncune 
or exclusive task naime at power fail 



24(18) 



Queue task name (n) 



Figure 2-2 Layout of Information Returned by 
STAQUE to BUFFER 
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TABLE 2-19 STATUS CODES FOR THE STAQUE 
SUBROUTINE 



CODE 

1 
2 
3 

12 
21 



STATUS 
No errors 

Buffer alignment errors 
Buffer not writable 
Insufficient buffer space 
Access to QUE could not be obtained 
Invalid QUE number 



2.22 STATAPU Subroutine 

The STATAPU subroutine returns information about the designated 
APU. 



Format: 



CALL STATAPU (APU_NO, BUFFER, BUFFEF_LENGTH,LENGTH_USED, 
HARDWARE_STATUS , STATUS ) 



Arguments : 
APU„NO 
BUFFER 



BUFFEEL-LENGTH 



LENGTH„USED 



is an integer *4 input argument specifying 
the APU number . 

is an integer *4 array that is unchanged 
if STATUS is nonzero. Otherwise, BUFFER 
is filled using the format in Figure 2-3. 

is an input integer *4 argument that 
indicates the number of elements in the 
array BUFFER that can be overwritten in 
this call. The minimum size is 40 bytes. 

is an integer*4 variable that indicates 
the number of elements in BUFFER actually 
filled by STATAPU. 
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HARDWARE_STATUS 



is an integer *4 variable that indicates 
the 2-:byte APU response status from the 
APU processor hardware. See the OS/32 
Supervisor Call (SVC) Manual for more 
information. 



STATUS 



is an integer *4 variable to which STATAPU 
sends a status code (see Table 2-20 for 
possible status codes). 



0(0) 
APU number 



1(1) 12(2) Queue 

Queue number | number at 
I power fail 



3(3) 
Unused 



4(4) 



APU processing status 



16(6) 



APU options 



8(8) 



12(C) 



Active task name 

or 
Waiting task name 



16(10) 



20(14) 



Control task name 



24(18) 



28(1C) 



32(20) 



36(24) 



Writable control store 
(WCS) image file descriptor 



Figure 2-3 



Layout of Information Returned 
by STATAPU to BUFFER 
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For a complete explanation of the above field names, see the 
OS/32 Supervisor Call (SVC) Reference Manual. 



TABLE 2-20 STATUS CODES FOR THE STATAPU 
SUBROUTINE 




STATUS I 

No error, requested function completed | 



Buffer alignment error 
Buffer not writable 
Insufficient buffer space 
Invalid APU number 



2.23 STOPAPU Subroutine 

The STOPAPU subroutine causes the designated APU to stop if it is 
currently executing. 



Format: 



CALL STOPAPU ( APU_NO , HARDWARE_STATUS , STATUS ) 



Arguments : 
APU_NO 
HARDWARE_STATUS 



STATUS 



is an integer* 4 input argument 
specifies the APU number. 



that 



is an integer *4 variable that indicates 
the 2-byte APU response status from the 
APU processor hardware. See the OS/32 
Supervisor Call (SVC) Reference Manual 
for more information. 

is an integer *4 variable to which STOPAPU 
sends a status code (see Table 2-21 for 
possible status codes). 
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TABLE 2-21 STATUS CODES FOR THE STOPAPU SUBROUTINE 



CODE 

4 
5 

6 
11 
18 



;s?xais.^E?s-s'=; 



STATUS 
No errors 
Error, task options prevent granting of privilege 

Task has not been granted privileges required to 
perform option 

Invalid APU number 

APU not enabled (DISABLED state) 

Task to be preempted, not on specified APU ready 
queue 



2.24 STRTAPU Subroutine 

The STRTAPU subroutine starts the designated APU for task 
execution. 



Format : 



CALL STRTAPU (APU_NO, HARDWARE_STATUS , STATUS) 



Arguments ; 



APU_NO 



HARDWARE._STATUS 



STATUS 



is an integer *4 input argument 
specifies the APU number. 



that 



is an integer *4 variable that indicates 
the 2-byte APU response status from the 
APU processor hardware. See the OS/32 
Supervisor Call (SVC) Reference Manual 
for more information. 

is an integer*4 variable to which STRTAPU 
sends a status code (see Table 2-22 for 
possible status codes). 
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TABLE 2-22 STATUS CODES FOR THE STRTAPU SUBROUTINE 

CODE I STATUS 

I No errors 

4 I Error, task options prevent granting of privilege 

5 I Task has not been granted privileges required to 
I perform option 

6 I Invalid APU number 

11 I APU not enabled (DISABLED state) 

18 I Task to be preempted, not on specified APU ready 

I queue 



2.25 TRLPU Subroutine 

The TRLPU subroutine assigns the designated LPU to the directed 
task and transfers that task to the LPU. If not self -directed, 
the task is suspended and assigned to its new LPU. The LPU 
directed option is turned on and the task is released from the 
suspended state. If the desired task is ready with a higher 
priority than the current task, it is immediately transferred to 
the APU queue. 



Format: 



CALL TRLPU (TASK I D,LPU_NO, STATUS) 



Arguments : 



TASK ID 



LPU_NO 



STATUS 



is an 8-byte input argument containing the 
task name. If this argument is an integer *4 
zero, the call is self -directed. 

is an integer *4 input argument specif ing the 
LPU number . 

is an integer *4 variable to which TRLPU 
returns a status code after execution (see 
Table 2-23 for possible status codes). 



2-26 



48-152 FOO ROO 



TABDE 2-23 STATUS CODES FOR THE TRLPU SUBROUTINE 



STATUS 

No error, requested function completed 

Syntax error in TASKID 

No such task in calling task environment 

The calling task cannot execute SVC6 control or 
communication functions 

LPU number is outside system generation (sysgen) 
range 




Specified task is APU only 
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